home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / man / cat.1 / mpeg_stat.1 < prev    next >
Text File  |  1995-07-25  |  15KB  |  331 lines
  1.  
  2.  
  3.  
  4.      MMMMPPPPEEEEGGGG____SSSSTTTTAAAATTTT((((1111))))     UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((1111 DDDDeeeecccceeeemmmmbbbbeeeerrrr 1111999999994444))))     MMMMPPPPEEEEGGGG____SSSSTTTTAAAATTTT((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           mpeg_stat - analyzes MPEG-1 encoded bitstreams
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.           mmmmppppeeeegggg____ssssttttaaaatttt [ ----aaaallllllll bbbbaaaasssseeeennnnaaaammmmeeee ] [ ----bbbblllloooocccckkkk____iiiinnnnffffoooo ffffiiiilllleeeennnnaaaammmmeeee ] [ ----ddddcccctttt
  13.           ] [ ----eeeennnndddd NNNN ] [ ----hhhhiiiissssttttooooggggrrrraaaammmm ffffiiiilllleeeennnnaaaammmmeeee ] [ ----ooooffffffffsssseeeettttssss ffffiiiilllleeeennnnaaaammmmeeee ] [
  14.           ----qqqqssssccccaaaalllleeee ffffiiiilllleeeennnnaaaammmmeeee ] [ ----qqqquuuuiiiieeeetttt ] [ ----rrrraaaatttteeee ffffiiiilllleeeennnnaaaammmmeeee ] [ ----
  15.           rrrraaaatttteeeelllleeeennnnggggtttthhhh NNNN ] [ ----ttttiiiimmmmeeee ] [ ----ssssiiiizzzzeeee ffffiiiilllleeeennnnaaaammmmeeee ] [ ----ssssttttaaaarrrrtttt NNNN ] [
  16.           ----ssssyyyysssslllloooogggg ffffiiiilllleeeennnnaaaammmmeeee ] [ ----uuuusssseeeerrrrddddaaaattttaaaa ffffiiiilllleeeennnnaaaammmmeeee ] [ ----vvvveeeerrrriiiiffffyyyy ] [[[[
  17.           ffffiiiilllleeee____nnnnaaaammmmeeee ]]]]
  18.  
  19.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  20.           mmmmppppeeeegggg____ssssttttaaaatttt decodes mpeg-1 encoded bitstreams collecting
  21.           varying amounts of statistics.  Errors are sent to stderr,
  22.           basic statistics to stdout.  The basic information is the
  23.           pattern of frames used, number of bytes for each frame type,
  24.           the specified parameters, and lengths of vectors.  For each
  25.           frame type, the average size, compression rate, Q-factor,
  26.           and time to decode are given.  Wherever a filename is
  27.           requested - can be used to denote stdin/out.
  28.  
  29.      OOOOPPPPTTTTIIIIOOOONNNNSSSS
  30.           ----aaaallllllll bbbbaaaasssseeeennnnaaaammmmeeee : records information from all options
  31.                (qscale, block_info, etc.) into files with basenames of
  32.                basename (For wizards, -all foo -block_info bar will
  33.                record all options BUT -block_info into files of the
  34.                form foo.*).
  35.  
  36.           ----bbbblllloooocccckkkk____iiiinnnnffffoooo ffffiiiilllleeeennnnaaaammmmeeee : records information about every block
  37.                into file filename.  Useful for detailed analysis and
  38.                to make specifics files for re-encoding (see
  39.                block2spec).  The format is:
  40.  
  41.                frame frame# IPB-type
  42.  
  43.                slice slice# q-scale
  44.  
  45.                block block# IPB-type Q-scale bits block-type
  46.                     <vectors-if-any> <cbp> <dct decode>
  47.           Numbering starts at 0 (except slices) and all motion vectors
  48.           are in half-pel units.
  49.  
  50.           ----ddddcccctttt : enables the decoded dct values to be output into the
  51.                block file.
  52.  
  53.           ----eeeennnndddd NNNN : causes mpeg_stat to finish collecting statistics at
  54.                frame N.
  55.  
  56.           ----hhhhiiiissssttttooooggggrrrraaaammmm ffffiiiilllleeeennnnaaaammmmeeee : summaries the overall statisitcs for
  57.                each frame type into the file.
  58.  
  59.           ----ooooffffffffsssseeeettttssss ffffiiiilllleeeennnnaaaammmmeeee : record the offset of every picture, GOP,
  60.  
  61.  
  62.  
  63.      Page 1                                           (printed 7/7/95)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      MMMMPPPPEEEEGGGG____SSSSTTTTAAAATTTT((((1111))))     UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((1111 DDDDeeeecccceeeemmmmbbbbeeeerrrr 1111999999994444))))     MMMMPPPPEEEEGGGG____SSSSTTTTAAAATTTT((((1111))))
  71.  
  72.  
  73.  
  74.                and slice into file filename.
  75.  
  76.           ----qqqquuuuiiiieeeetttt : toggles the display of the frame-types as they are
  77.                parsed (and custom quantization matrices) [default:
  78.                on].
  79.  
  80.           ----qqqqssssccccaaaalllleeee ffffiiiilllleeeennnnaaaammmmeeee : writes Q factor and custom quantization
  81.                matrix information into file filename.  The Q-factor
  82.                and number of blocks of that quality (ignoring skipped
  83.                blocks) for each type of frame is recorded.
  84.  
  85.           ----rrrraaaatttteeee ffffiiiilllleeeennnnaaaammmmeeee : record the bit rate at every picture (after
  86.                the first second) into the file filename.  Also collect
  87.                minimum and maximum bit rate encountered in the summary
  88.                information.  (Rate is the number of bits used per
  89.                second, at every frame).
  90.  
  91.           ----rrrraaaatttteeeelllleeeennnnggggtttthhhh NNNN : Change the measurement period for rate to N,
  92.                so it will measure the total rate required over any N
  93.                frame period (after the first N, of course).
  94.  
  95.           ----ssssiiiizzzzeeee ffffiiiilllleeeennnnaaaammmmeeee : stores information about the type (I,P,B)
  96.                and size of each frame in file filename (one frame per
  97.                line).
  98.  
  99.           ----ssssttttaaaarrrrtttt NNNN : causes mpeg_stat to begin collecting statistics
  100.                at frame N.  (Preceding frames will be parsed, but few
  101.                statistics are collected (the system layer counters
  102.                will sill be running).) ----ssssyyyysssslllloooogggg ffffiiiilllleeeennnnaaaammmmeeee : describes
  103.                the parsing of the system layer into the file filename.
  104.                Note this option is not turned on by -all.  ----ttttiiiimmmmeeee :
  105.                prints the amount of time total and per-frame type
  106.                averages to decode.  This will give an estimate of time
  107.                in a software player, but is not generally useful, so
  108.                it is off by default.  ----uuuusssseeeerrrrddddaaaattttaaaa ffffiiiilllleeeennnnaaaammmmeeee : dumps user
  109.                data fields into a file.  Can be read in ASCII.  ----
  110.                vvvveeeerrrriiiiffffyyyy : does more work to check the validity of the
  111.                sequence.  Slows down the statistics, so it is
  112.                optional.
  113.  
  114.      EEEEXXXXAAAAMMMMPPPPLLLLEEEE
  115.           Decoding the flowergarden sequence (mpeg_stat -quiet
  116.           flower.mpg) should produce the following statistics:
  117.  
  118.  
  119.           Reading /u/smoot/mpg/flower.mpg
  120.  
  121.           Frame sequence as to be displayed:
  122.           BBPBBPBBPBBPBBIBBPBBPBBPBBPBBIBBPBBPBBPBBPBBIBBPBBPBBPBBPBBIBBPBBPBBPBBPBBI
  123.           BBPBBPBBPBBPBBIBBPBBPBBPBBPBBIBBPBBPBBPBBPBBIBBPBBPBBPBBPBBIBBPBBPBBPBBPBB
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                           (printed 7/7/95)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      MMMMPPPPEEEEGGGG____SSSSTTTTAAAATTTT((((1111))))     UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((1111 DDDDeeeecccceeeemmmmbbbbeeeerrrr 1111999999994444))))     MMMMPPPPEEEEGGGG____SSSSTTTTAAAATTTT((((1111))))
  137.  
  138.  
  139.  
  140.           Searching for constant frame type sequence...pattern
  141.           detected: IBBPBBPBBPBBPBB
  142.  
  143.  
  144.           SUMMARY:
  145.  
  146.           Total Bytes read: 0. Total number of frames: 150.  Length is
  147.           5.01 sec
  148.  
  149.           Width: 352      Height: 240 Avg. Frame Size: 4786 bytes + 6
  150.           bits  (average rate 1147692.76 bits/sec)
  151.  
  152.           Total Compression Rate:  1.89 % of uncompressed 24 bit
  153.           images
  154.                                   =  0.45 bits per pixel
  155.  
  156.           Number of Macroblocks [width * height = sum]: 22 x 15 = 330
  157.           per frame Skipped Macroblocks = 4389 (9.46%), Coded
  158.           Macroblocks = 41992 (90.54%)
  159.  
  160.           Total Time Decoding: 8.611 secs. 0.05721 sec/frame or 17.11
  161.           frames/sec.
  162.  
  163.           MPEG-Viewer requirements:
  164.                   Pixel aspect ratio of 0.6735
  165.                   Required display speed: 29.97 frames/sec
  166.                   Specified bit rate is 1.00 MBits/sec (2500 *
  167.           400bits/sec)
  168.                   Requested buffer size is 8K ints (16 bits).
  169.                   And the constrained parameter flag is on.       The
  170.           stream meets the constrained parameter requirements.
  171.  
  172.           Length of vectors in pixels:
  173.                   Horizontal forward vectors, maximum :  39
  174.           average:   6
  175.                   Vertical forward vectors, maximum   :  22
  176.           average:   1
  177.  
  178.                   Horizontal backward vectors, maximum:  29
  179.           average:   5
  180.                   Vertical backward vectors, maximum  :  16
  181.           average:   1
  182.  
  183.  
  184.           Frame specific information:
  185.  
  186.               10  I FRAMES, average is:
  187.                   Size: 17323 bytes + 1 bits (24.13%)
  188.                   Compression Rate:  6.84%
  189.                   Q Factor [scales quantization matrix]: 11.15
  190.                   Time to Decode: 0.114039 secs.
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                                           (printed 7/7/95)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      MMMMPPPPEEEEGGGG____SSSSTTTTAAAATTTT((((1111))))     UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((1111 DDDDeeeecccceeeemmmmbbbbeeeerrrr 1111999999994444))))     MMMMPPPPEEEEGGGG____SSSSTTTTAAAATTTT((((1111))))
  203.  
  204.  
  205.  
  206.               40  P FRAMES, average is:
  207.                   Size: 8031 bytes + 0 bits (44.74%)
  208.                   Compression Rate:  3.17%
  209.                   Q Factor [scales quantization matrix]: 10.85
  210.                   Time to Decode: 0.075342 secs.
  211.  
  212.               100 B FRAMES, average is:
  213.                   Size: 2235 bytes + 4 bits (31.13%)
  214.                   Compression Rate:  0.88%
  215.                   Q Factor [scales quantization matrix]: 15.01
  216.                   50.59% interpolated Macro Blocks
  217.                   Time to Decode: 0.044516 secs.
  218.  
  219.  
  220.  
  221.      NNNNOOOOTTTTEEEESSSS
  222.           The analyzer expects MPEG-1 video streams only. It can
  223.           handle multiplexed MPEG streams (video+audio streams), but
  224.           mostly analyzes the video portion.
  225.  
  226.           Some streams do not end with the proper sequence end code
  227.           and will probably generate an "Improper sequence end code."
  228.           error when done.  In general mpeg_stat attempts to catch and
  229.           alert its user to errors in the stream.  Such errors are
  230.           glossed over in mpeg_play.  Be aware that errors can disturb
  231.           statistics gathering, generating odd results.
  232.  
  233.           This player can handle XING data files. Be aware that XING
  234.           makes no use of temporal redundancy or motion vector
  235.           information. In other words, they do not use any P or B
  236.           frames in their streams. Instead, XING data is simply a
  237.           sequence of I frames.
  238.  
  239.      HHHHIIIISSSSTTTTOOOORRRRYYYY
  240.           The analyzer is based on the UC Berkeley mpeg_play player by
  241.           Ketan Patel, Brian Smith, Henry Chi-To Ma, and Kim Man Liu.
  242.           It was modified at the Technical University of Berlin,
  243.           Germany, Dept. of Computer Science by Tom Pfeifer, Jens
  244.           Brettin, Harald Masche, Alexander Schulze, and Dirk
  245.           Schubert.  It has been further modified to collect much more
  246.           information by Steve Smoot (UC Berkeley).
  247.  
  248.      BBBBUUUUGGGGSSSS
  249.           No statistics should be collected before the start frame.
  250.           Sometimes system layer streams will indicate that they lack
  251.           proper end codes, when they have them.  VBV size conformance
  252.           is not checked.  Verification is not complete.  Frame
  253.           numbers should probably be in display numbering not stream
  254.           numbering.  Other bugs?  Send mail to <mpeg-
  255.           bugs@plateau.cs.berkeley.edu>.
  256.  
  257.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  258.  
  259.  
  260.  
  261.      PPPPaaaaggggeeee 4444                                           ((((pppprrrriiiinnnntttteeeedddd 7777////7777////99995555))))
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      MMMMPPPPEEEEGGGG____SSSSTTTTAAAATTTT((((1111))))     UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((1111 DDDDeeeecccceeeemmmmbbbbeeeerrrr 1111999999994444))))     MMMMPPPPEEEEGGGG____SSSSTTTTAAAATTTT((((1111))))
  269.  
  270.  
  271.  
  272.           This is version 2.2, contining some new features since 2.1,
  273.           and several bug fixes.  It is a major change since version
  274.           1.0.
  275.  
  276.      AAAAUUUUTTTTHHHHOOOORRRRSSSS
  277.           Ketan Patel - University of California, Berkeley,
  278.                kpatel@cs.berkeley.edu
  279.  
  280.           Brian Smith - University of California, Berkeley,
  281.                bsmith@cs.berkeley.edu
  282.  
  283.           Henry Chi-To Ma - University of California, Berkeley,
  284.                cma@cs.berkeley.edu
  285.  
  286.           Kim Man Liu - University of California, Berkeley,
  287.                kliu@cs.berkeley.edu
  288.  
  289.           Tom Pfeifer - Multimedia systems project -
  290.                pfeifer@fokus.gmd.de
  291.  
  292.           Steve Smoot - University of California, Berkeley,
  293.                smoot@cs.berkeley.edu
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.      Page 5                                           (printed 7/7/95)
  328.  
  329.  
  330.  
  331.